Skip to main content
GET
/
empresas
/
campaigns
/
{businessId}
curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1?datePreset=last_7d&accountId=act_123456789&showOnlyActives=false" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "120200000000001",
      "name": "Campaña Verano 2026",
      "status": "ACTIVE",
      "lifetime_budget": "5000000",
      "budget_remaining": "2000000",
      "start_time": "2026-01-01T00:00:00Z",
      "stop_time": "2026-06-30T23:59:59Z",
      "sales_totales": 5,
      "insights": { "data": [] },
      "ads": { "data": [] }
    }
  ],
  "totalSales": 42,
  "totalSpend": 1500.75,
  "totalQuotations": 18,
  "next": null
}

Documentation Index

Fetch the complete documentation index at: https://developer.iobot.chat/llms.txt

Use this file to discover all available pages before exploring further.

Retorna las campañas de Meta Ads vinculadas a un negocio, junto con totales de gasto (totalSpend), ventas (totalSales) y cotizaciones (totalQuotations) para el período solicitado. Solo retorna campañas que tengan al menos un anuncio con gasto, ventas o cotizaciones.

​
Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

​
Parámetros de ruta

​
businessId
number
required
ID del negocio cuyas campañas se desean obtener.

​
Parámetros de consulta

​
datePreset
string
required
Período predefinido. Valores aceptados: today, yesterday, last_7d, last_30d, this_month, maximum.
​
accountId
string
required
ID de la cuenta publicitaria de Meta. Obténlo desde [Obtener Cuentas Publicitarias](/Campañas meta/obtener-cuentas-publicitarias).
​
start
string
Fecha de inicio en formato ISO 8601. Usada para filtrar ventas y cotizaciones.
​
end
string
Fecha de fin en formato ISO 8601. Usada para filtrar ventas y cotizaciones.
​
showOnlyActives
boolean
Si es true, filtra y devuelve solo las campañas con estado activo. Por defecto false.

​
Respuesta

​
data
array
Lista de campañas de Meta Ads.
​
totalSales
number
Total de ventas generadas en el período.
​
totalSpend
number
Gasto total en el período.
​
totalQuotations
number
Total de cotizaciones generadas en el período.
​
next
string | null
Cursor de paginación para obtener la siguiente página de campañas. null si no hay más resultados.
curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1?datePreset=last_7d&accountId=act_123456789&showOnlyActives=false" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "120200000000001",
      "name": "Campaña Verano 2026",
      "status": "ACTIVE",
      "lifetime_budget": "5000000",
      "budget_remaining": "2000000",
      "start_time": "2026-01-01T00:00:00Z",
      "stop_time": "2026-06-30T23:59:59Z",
      "sales_totales": 5,
      "insights": { "data": [] },
      "ads": { "data": [] }
    }
  ],
  "totalSales": 42,
  "totalSpend": 1500.75,
  "totalQuotations": 18,
  "next": null
}